home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / Communication / Citadel_BBS / Docs / Cit_Amiga_Docs.lha / cit.other < prev    next >
Text File  |  1994-05-30  |  9KB  |  218 lines
  1. Document Citadel 68K 
  2. Citadel  68K  is  a freeware product that may be distributed
  3. only  for  the  cost of distribution.  No fees maybe charged
  4. for it's use.  
  5.  
  6. 0. Introduction and History       
  7. Citadel  68k  is  a  freeware bbs that grew out of a port of
  8. the IBM Citadel 86 by Hue Jr.  
  9.  
  10.      Citadel was   written  in  mid-December  1981  by  CrT.
  11. Miraculously,  it ran three days unattended over New Year's,
  12. collecting  some remarkably favorable reactions.  During the
  13. months  that  it  ran at 633-3282 (ODD-DATA), Citadel became
  14. one  of  the  more  popular  BBs in town, and there was some
  15. disappointment  when  a  hardware  failure forced the system
  16. down  in February of 1982.  But in January CrT had published
  17. the source code in BDS C, putting it in the public domain.  
  18.  
  19.      David Mitchell  brought  up the next incarnation of the
  20. Citadel  program  in  April  of  1982,  running  on hardware
  21. provided  by  Richard Knox.  Called the Island Communication
  22. System,  it  is located on Bainbridge Island in Puget Sound.
  23. ICS  has  about  30 regular users and about 120 log entries.
  24. Newcomers  find  it  easy to learn, and often leave messages
  25. praising  it.   Some  of  the  system's  daily  users are in
  26. Boston.  
  27.  
  28.      Citadel is  descended from DandD.pas, an adventure game
  29. editor/driver.   It  is  arranged  as  a  series  of  rooms,
  30. starting  with  the  LOBBY.   In each room the user can read
  31. existing  messages  and  leave more.  There may be up to 128
  32. rooms   in  the  current  implementation.   The  system  was
  33. brought  up with only one room, the LOBBY.  Additional rooms
  34. were  created  by  the users, with room names appropriate to
  35. the topics covered.  
  36.  
  37. 1. Today         
  38. The  Citadel  68K  today  is  based  on regular ports of the
  39. Citadel  86.   This  version,  3.42.P20 is based on the 3.42
  40. Citadel  86.   There  are  currently  efforts  to port later
  41. versions,  but  a  lack of time has slowed the efforts.  The
  42. original  port was done by Jay Johnston.  Jay eventually ran
  43. into  time  pressures  and  lack of equipment and transfered
  44. the  maintenance  to  me,  Tony  Preston.  I have fixed many
  45. bugs,  done  a complete re-port of the 3.42, and continue to
  46. work on keeping the Amiga Citadel as current as possible.  
  47.  
  48. 2. What is ported       
  49. The    `Utilities',    `Configuration   Program',   `Support
  50. Programs'  and  the `Main Executable' are the most important
  51. items  for running Citadel.  These make up the whole Citadel
  52. distribution.  
  53.  
  54. 3. Warranty and Costs       
  55. Citadel  is  Freeware.   No  charge  may  be  made  for  the
  56. program,  utilities,  or  any  portion  of the basic Citadel
  57. archives.    Some   of  the  extra  `Support  Programs'  are
  58. shareware  and have fees associated with their use.  Citadel
  59. is  fairly  low on bugs.  The bugs that do exist, are either
  60. hard  to duplicate, or minor enough that the rarely occur or
  61. cause  problems.   Citadel  is  well  supported, to report a
  62. bug,  all  you  have  to do is post a message in the Citadel
  63. 68K room, and it will be archived and eventually fixed.  
  64.  
  65. 4. Configuration Program        
  66. The  Configuration program reads a special file and produces
  67. the  `CTDLTABL.SYS'  file which contains all the information
  68. the  BBS  needs to run.  It also will create other files the
  69. BBS needs to run.  
  70.  
  71. 5. Introduction         
  72. The   Citadel  BBS  program  works  based  on  a  predefined
  73. configuration  generated  by  the `CONFG' program.  You must
  74. create  the  `CTDLCNFG.SYS' file either from scratch or from
  75. the example in the archive.  
  76.  
  77. 6. limits         
  78. Since  Citadel  is a port from the 16 bit IBM world, keep in
  79. mind  that  some  of  the limits stem from that environment.
  80. To  remain  100%  compatible,  the  same limits apply to the
  81. Amiga  Version.   In  reality,  those  limits  do not effect
  82. operation  since  few  systems  are as large as those limits
  83. allow.  
  84.  
  85. 7. CTDLCNFG.SYS         
  86. This  file contains all the configuration directives for the
  87. `CONFG'  program.   They  are presented here in alphabetical
  88. order  for ease of location.  Additional sections will refer
  89. to  specific  parameters cross referencing these items later
  90. on.  
  91.  
  92. 8. #HELPAREA         
  93. This  option  controls  the  location  of the three types of
  94. help files.  The `.BLB', `.MNU', and `.HLP' files.  
  95.  
  96. 9. .BLB         
  97. These  files contain miscellaneous messages and warnings for
  98. use in certain set locations of Citadel-86.  
  99.  
  100. 10. .MNU         
  101. These  files  contain  menus  that  are normally printed out
  102. when  the user touches '?' while using Citadel-86.  Usually,
  103. these are just lists of options.  
  104.  
  105. 11. .HLP         
  106. These  are  general  help  files that are accessible through
  107. the   .Help  <filename>  command.   Generally,  these  files
  108. contain  terse  instructions  on  the  use  of  the  system,
  109. including  references  to other files that may be of help to
  110. the user.  
  111.  
  112. 12. Optional Customization        
  113. The  Help  files  as  delivered are of a generic nature, and
  114. any  of  them  may  be  modified  using a text editor at the
  115. Sysop's  option.   The  `.BLB'  files  are generally English
  116. descriptions  of operations, and can be modified for greater
  117. readability/useability with little danger of any problems.  
  118.  
  119.      On the  other  hand,  the  `.MNU'  files  should not be
  120. modified  impulsively,  since  they  consist  mostly of menu
  121. lists.  
  122.  
  123.      The `.HLP'   files   are   the   best   candidates  for
  124. customization,  since  they  are  English descriptions, and,
  125. for  the  most  part,  are not "hard-coded" into Citadel-86;
  126. rather,  they  are usually referenced by the user after they
  127. finds a reference to them.  
  128.  
  129.      All help  files  are  formatted just like messages when
  130. they  are  displayed  to  the user; therefore, you should be
  131. sure  to  follow  the  normal  Citadel formatting rules when
  132. rewriting  Help  files, except that you needn't place a lone
  133. space on a blank line to enforce that blank line (a 
  134.  
  135.      difficult thing to do with many editors).  
  136.  
  137. 13. Warnings and Problems       
  138. To Be Supplied.  
  139.  
  140. 14. Main Executable        
  141. To Be Supplied.  
  142.  
  143. 15. Help Files        
  144. The  location  of  the  Help  files  is  controlled  by  the
  145. `#HELPAREA' parameter in the configuration 
  146.  
  147. 16. options         
  148. To Be Supplied.  
  149.  
  150. 17. suggestions         
  151. To Be Supplied.  
  152.  
  153. 18. basic operation        
  154. To Be Supplied.  
  155.  
  156. 19. networking         
  157. To Be Supplied.  
  158.  
  159. 20. Utilities         
  160. To Be Supplied.  
  161.  
  162. 21. what is ported and why     
  163. To Be Supplied.  
  164.  
  165. 22. (one per item)       
  166. To Be Supplied.  
  167.  
  168. 23. Support Programs        
  169. To Be Supplied.  
  170.  
  171. 24. XPR support        
  172. To Be Supplied.  
  173.  
  174. 25. Archiver Support        
  175. To Be Supplied.  
  176.  
  177. 26. Door Interface        
  178. To Be Supplied.  
  179.  
  180. 27. Citadel AUX handler       
  181. To Be Supplied.  
  182.  
  183. 28. Installation         
  184. To Be Supplied.  
  185.  
  186.              T a b l e   o f   C o n t e n t s
  187.  
  188. 0 Introduction and History      ......................    1
  189. 1 Today        .......................................    1
  190. 2 What is ported      ................................    1
  191. 3 Warranty and Costs      ............................    1
  192. 4 Configuration Program       ........................    1
  193. 5 Introduction        ................................    1
  194. 6 limits        ......................................    1
  195. 7 CTDLCNFG.SYS        ................................    1
  196. 8 #HELPAREA        ...................................    1
  197. 9 .BLB        ........................................    1
  198. 10 .MNU        .......................................    1
  199. 11 .HLP        .......................................    1
  200. 12 Optional Customization       ......................    1
  201. 13 Warnings and Problems      ........................    1
  202. 14 Main Executable       .............................    1
  203. 15 Help Files       ..................................    1
  204. 16 options        ....................................    1
  205. 17 suggestions        ................................    1
  206. 18 basic operation       .............................    1
  207. 19 networking        .................................    1
  208. 20 Utilities        ..................................    1
  209. 21 what is ported and why    .........................    1
  210. 22 (one per item)      ...............................    1
  211. 23 Support Programs       ............................    1
  212. 24 XPR support       .................................    1
  213. 25 Archiver Support       ............................    1
  214. 26 Door Interface       ..............................    1
  215. 27 Citadel AUX handler      ..........................    1
  216. 28 Installation        ...............................    1
  217.  
  218.